全球首个且最好的专为 AI 智能体设计的 Office 套件
小G GitHubStore 2026年6月22日 08:54
以前每次让AI帮忙做个PPT或者改Excel,总觉得它“懂个大概”,但真正动手时不是格式乱七八糟,就是直接卡壳。
且传统方式用Python处理Office文件,常常要装一堆库,代码写几十行,还容易出兼容问题。尤其是复杂图表、样式、国际化支持,动不动就翻车。
什么是OfficeCLI?
简单说,它是一个专为AI智能体设计的Office工具套件。开源免费、单文件运行、无需安装Microsoft Office,全平台都能用。 它最大的亮点在于:不仅能让AI读写Word、Excel、PowerPoint,还内置了渲染引擎,能把文档实时转成HTML或图片,AI“看”得见自己做的效果,改起来自然就准多了。
OfficeCLI 是全球首个、也是最好的专为 AI 智能体设计的 Office 套件。
让任何 AI 智能体完全掌控 Word、Excel 和 PowerPoint——只需一行代码。
开源免费。单一可执行文件。无需安装 Office。零依赖。全平台运行。
内置 agent 友好渲染引擎 —— 智能体可以“看见”自己创建的内容,无需 Office。把 .docx / .xlsx / .pptx 渲染为 HTML 或 PNG,“渲染 → 看 → 改”循环在二进制能运行的任何地方都成立。
AI 智能体 — 一行搞定
把下面这行命令粘贴到你的 AI 智能体对话框中,它会自动读取技能文件并完成安装:
curl -fsSL https://officecli.ai/SKILL.md
仅此一步。技能文件会教智能体如何安装二进制文件并使用所有命令。
普通用户
方式 A — 图形界面: 安装 AionUi —— 一款桌面应用,支持用自然语言创建和编辑 Office 文档,底层由 OfficeCLI 驱动。只需描述你想要什么,AionUi 就会帮你完成。
方式 B — 命令行: 从 GitHub Releases 下载对应平台的二进制文件,然后运行:
officecli install
此命令会将二进制文件复制到 PATH,并自动将 officecli 技能文件 安装到检测到的所有 AI 编程助手(如 Claude Code、Cursor、Windsurf、GitHub Copilot 等)。你的智能体可以立即为你创建、读取和编辑 Office 文档,无需额外配置。
快速开始
# 创建演示文稿并添加内容
officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
officecli add deck.pptx '/slide[1]' --type shape \
--prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
--prop font=Arial --prop size=24 --prop color=FFFFFF
# 查看大纲
officecli view deck.pptx outline
# 查看 HTML 渲染预览
officecli view deck.pptx html
# 获取结构化 JSON
officecli get deck.pptx '/slide[1]/shape[1]' --json
# 保存并关闭
officecli close deck.pptx
关键技术
1. 编程语言与运行时
- C# +.NET :整个项目核心使用 C# 开发(
src/officecli/目录下大量.cs文件,包含officecli.csproj)。 - 单文件自包含发布 :使用.NET 的 Single-File Publish + Native AOT (或 trimmed self-contained)技术,打包成 零依赖单二进制文件 ,支持 Windows、macOS、Linux 全平台,无需安装.NET 运行时。
- 项目使用
officecli.slnx解决方案文件,构建脚本build.sh。
2. Office 文件处理核心:Open XML SDK
- DocumentFormat.OpenXml (NuGet 包)是底层基础库。
- 直接操作 OOXML(Office Open XML)格式(ZIP 包 + XML 部件),无需 Microsoft Office 安装或 COM 互操作。
- 优势:跨平台、精确控制结构、样式、公式、图表等,避免传统 Python 库(如 python-docx、python-pptx、openpyxl)的兼容性和功能局限。
3. 架构设计:模块化 Handler + Core 引擎
- DocumentHandlerFactory :根据文件扩展名(.docx /.xlsx /.pptx)分发到对应 Handler:
WordHandler.csExcelHandler.csPowerPointHandler.cs
- Core/ 目录:共享基础设施
HtmlPreviewHelper.cs、HtmlScreenshot.cs:内置 HTML/PNG 渲染(代理友好,AI 可“看见”输出)。watch命令实时预览(本地 HTTP 服务 + 自动刷新)。
- 路径查询系统 :自定义 CSS-like / XPath-like 选择器(
GenericXmlQuery.cs、SelectorPositionalIndex.cs、PathAliases.cs),支持/slide[1]/shape[2]、Excel 行过滤row[Salary>5000 and Region=EMEA]等。- DOM-like 抽象 :
DocumentNode.cs等模型,便于 AI 友好操作。 - 渲染引擎 :
- Resident Mode (常驻模式):
ResidentServer.cs/ResidentClient.cs,保持文档在内存中,批量操作时避免反复打开/保存,提升性能。
- DOM-like 抽象 :
4. 高级功能实现
- Excel 公式与 Pivot :
Core/Formula/目录:内置 150+ 函数求值引擎、公式引用重写(FormulaRefShifter.cs)。PivotTableHelper.cs(多文件):完整支持 PivotTable 创建、缓存、布局、计算字段等,原生 OOXML 输出。
- 国际化与复杂特性 :
- BCP-47 语言标签、
LocaleFontRegistry.cs、WordStrictAttributeSanitizer.cs等,支持 RTL、CJK、复杂脚本。- 修订追踪(revisions)、批注、域、内容控件(SDT)、OLE 对象等深度支持。
- 插件系统 (
Core/Plugins/):扩展 PDF 导出、其他格式等。 - Batch / Dump / Merge :JSON 序列化/反序列化,支持 round-trip(dump → batch 编辑)。
- 验证与诊断 :OpenXML Schema 验证 + 自定义 Issue 检测(溢出、缺失 alt text 等)。
5. AI 代理优化特性
- 命令行友好 :丰富 CLI(System.CommandLine 或类似),
CommandBuilder.*.cs分模块处理 add/set/get 等。 - JSON 输出 :结构化结果,便于 AI 解析和链式调用。
- Skill / MCP 支持 :内置 SKILL.md 安装、MCP Server(Model Context Protocol),无缝集成 Claude、Cursor 等 AI 工具。
- 无头 / CI 友好 :渲染、预览、批处理均支持无界面环境。
6. 其他技术亮点
- 性能与兼容 :EMU 单位转换、
EmuConverter.cs、Units.cs;颜色主题解析、ThemeHandler.cs;字体度量、FontMetricsReader.cs。 - 安全与构建 :GitHub Actions CI、代码签名(macOS notarization)、第三方通知。
- 辅助工具 :模板合并(
TemplateMerger.cs)、CSV 导入、图像/SVG 处理等。
项目地址
https://github.com/iOfficeAI/OfficeCLI
如果你觉得这篇文章不错,别忘了 点赞、在 看、转发 给更多需要的小伙伴哦!
AIAgent · 目录
继续滑动看下一个
GitHubStore
向上滑动看下一个